home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / minix / up1510b.tgz / up1510b / doc / elle.doc < prev    next >
Text File  |  1990-07-19  |  15KB  |  348 lines
  1. 1. INTRODUCTION TO ELLE
  2.      ELLE (ELLE Looks Like Emacs) is an Emacs clone for MINIX.  It was
  3. written by Ken Harrenstien of SRI.  His e-mail address is klh@sri-nic.arpa.  
  4. ELLE is not full Emacs but it has about 80 commands and is quite fast.
  5.  
  6. 1.1 Key bindings
  7.      Mined only has a small number of commands.  All of them are either of
  8. the form CTRL-x or are on the numeric keypad.  Emacs, in contrast, has so
  9. many commands, that not only are all the CTRL-x commands used up, but so
  10. are all the ESC x (escape followed by x; escape is not a shift character,
  11. like CTRL).  Even this is not enough, so CTRL-X is used as a prefix for
  12. additional commands.  Thus CTRL-X CTRL-L is a command, and so is CTRL-X K.
  13. Note that what is conventionally written as CTRL-X K really means CTRL-X k.
  14.  
  15.      As a result, many Emacs commands need three or four key strokes to 
  16. execute.  Some people think 3-4 key strokes is too many.
  17. For this reason, Emacs and ELLE allow users to assign their own key bindings.
  18. In ELLE this is done with "user profiles."  A user profile is a file listing
  19. which function is invoked by which key stroke.  The user profile is then
  20. compiled by a program called ellec into binary form.  When ELLE starts up
  21. it checks to see if a file .ellepro.b1 exists in $HOME.  If it does, this
  22. file is read in and overrides the default bindings.  
  23.  
  24.      I have written a user profile that simulates the mined commands fairly
  25. well.  Its installation is described later.  If you have never used Emacs, 
  26. I suggest that you use the mined profile.  If you normally use Emacs, then
  27. do not install the mined profile.  You can also make your own.
  28.  
  29.      ELLE has a character-oriented view of the world, not a line oriented
  30. view, like ed.  It does not have magic characters for searching, however, you
  31. can use line feed in search patterns.  For example, to find a line consisting
  32. of the three characters "foo" all by themselves on a line, using the mined
  33. bindings (see below), use the pattern: CTRL-\ CTRL-J f o o CTRL-\ CTRL-J.
  34. The CTRL-\ means to interpret the next character literally, in this case it
  35. is CTRL-J, which is line feed.  You can also search for patterns involving 
  36. multiple lines.  For example, to find a line ending in an "x" followed by a
  37. line beginning with a "y", use as pattern: x CTRL-\ CTRL-J y.
  38.  
  39. 2. MINED KEY BINDINGS
  40.  
  41.      These are the key bindings if the binary user profile, .ellepro.b1,
  42. is installed in $HOME.  The ESCAPE key followed by a number followed by a
  43. command causes that command to be executed "number" times.  This applies
  44. both to control characters and insertable characters.  CTRL-X refers to a
  45. "control character."  ESC x refers to an escape character followed by x.
  46. ^X Y refers to CTRL-X followed by y.  To abort the current command and go
  47. back to the main loop of the editor, type CTRL-G, rather than CTRL-\.
  48.      Only a few commands are of the form CTRL-X Y.  All of these are also
  49. bound to CTRL-X CTRL-Y, so you can hold down CTRL and then hit X Y, or
  50. release control after the X, as you prefer.
  51.      The key bindings that are not listed should not be used.  Some of them 
  52. actually do things.  For example, the ANSI escape codes ESC [ x are bound 
  53. to ^X Y for a variety of y.
  54.      Some commands work on regions.  A region is defined as the text between
  55. the most recently set mark and the cursor.
  56.  
  57.     
  58. 2.1 Mined Commands
  59.  
  60. CURSOR MOTION
  61.    arrows   Move the cursor in the indicated direction
  62.    CTRL-A   Move cursor to start of current line
  63.    CTRL-Z   Move cursor to end of current line
  64.    CTRL-F   Move cursor forward word 
  65.    CTRL-B   Move cursor backward to start of previous word 
  66.  
  67. SCREEN MOTION
  68.    Home key Move to first character of the file
  69.    End key  Move to last character of the file
  70.    PgUp key Scroll window up 22 lines (closer to start of the file)
  71.    PgDn key Scroll window down 22 lines (closer to end of the file)
  72.    CTRL-U   Scroll window up 1 line
  73.    CTRL-D   Scroll window down 1 line
  74.    ESC ,    Move to top of screen
  75.    CTRL-_   Move to bottom of screen
  76.  
  77. MODIFYING TEXT
  78.    DEL key  Delete the character under the cursor
  79.    Backsp   Delete the character to left of the cursor
  80.    CTRL-N   Delete the next word
  81.    CTRL-P   Delete the previous word
  82.    CTRL-T   Delete tail of line (all characters from cursor to end of line)
  83.    CTRL-O   Open up the line (insert line feed and back up)
  84.    ESC G    Get and insert a file at the cursor position (CTRL-G in mined)
  85.  
  86. REGIONS
  87.    CTRL-^   Set mark at current position for use with CTRL-C and CTRL-K
  88.    CTRL-C   Copy the text between the mark and the cursor into the buffer
  89.    CTRL-K   Delete text between mark and cursor; also copy it to the buffer
  90.    CTRL-Y   Yank contents of the buffer out and insert it at the cursor
  91.  
  92. MISCELLANEOUS
  93.    numeric +    Search forward (prompts for expression)
  94.    numeric \(em Search backward (prompts for expression)
  95.    CTRL-]   ESC n CTRL-[ goes to line n (slightly different syntax than mined)
  96.    CTRL-R   Global replace pattern with string (from cursor to end)
  97.    CTRL-L   Replace pattern with string within the current line only
  98.    CTRL-W   Write the edited file back to the disk
  99.    CTRL-S   Fork off a shell (use CTRL-D to get back to the editor)
  100.    CTRL-G   Abort whatever the editor was doing and wait for command (CTRL-\)
  101.    CTRL-E   Redraw screen with cursor line positioned in the middle
  102.    CTRL-V   Visit (edit) a new file
  103.    CTRL-Q   Write buffer to a file
  104.    ESC X    Exit the editor
  105.  
  106. 2.2 Non-Mined Commands
  107.  
  108. CURSOR MOTION
  109.    ESC P Forward paragraph (a paragraph is a line beginning with a dot)
  110.    ESC ] Backward paragraph
  111.    ESC . Indent this line as much as the previous one
  112.  
  113. MODIFYING TEXT
  114.    CTRL-\ Insert the next character (used for inserting control characters)
  115.    ESC T Transpose characters
  116.    ESC W Transpose words
  117.    ESC = Delete white space (horizontal space)
  118.    ESC | Delete blank lines (vertical space)
  119.  
  120. REGIONS
  121.    ESC M Mark current paragraph
  122.    ESC ^ Exchange cursor and mark
  123.    ESC Y Yank back the next-to-the-last kill (CTRL-Y yanks the last one)
  124.    ESC A Append next kill to kill buffer
  125.  
  126. KEYBOARD MACROS
  127.    ESC / Start Keyboard Macro
  128.    ESC \ End Keyboard Macro
  129.    ESC * View Keyboard Macro (the PrtSc key on the numeric pad is also a *)
  130.    ESC E Execute Keyboard Macro
  131.  
  132. WINDOW MANAGEMENT
  133.    ^X 1  Enter one window mode
  134.    ^X 2  Enter two window mode
  135.    ^X L  Make the current window larger
  136.    ^X P  Make the window more petit/petite (Yes, Virginia, they are English)
  137.    ^X N  Next window
  138.    ^X W  New window
  139.  
  140. BUFFER MANAGEMENT
  141.    numeric 5    Display the list of current files and buffers
  142.    ESC B Select a buffer
  143.    ESC S Select an existing buffer
  144.    ESC N Mark a buffer as NOT modified (even if it really is)
  145.   
  146. UPPER AND LOW CASE MANIPULATION
  147.    ESC I Set first character of word to upper case
  148.    ESC C Capitalize current word
  149.    ESC O Make current word ordinary (i.e., lower case)
  150.    ESC U Set entire region between mark and cursor to upper case
  151.    ESC L Set entire region between mark and cursor to lower case
  152.  
  153. MISCELLANEOUS
  154.    ESC F Find file and read it into its own buffer
  155.    ESC Z Incremental search
  156.    ESC Q Like CTRL-R, but queries at each occurrence (type ? for options)
  157.    ESC R Reset the user profile from a file
  158.    ESC H Help (ELLE prompts for the 1 or 2 character command to describe)
  159.    ESC ; Insert a comment in a C program (generates /* */ for you)
  160.    ^X X  Exit the editor (same as ESC X and CTRL-X CTRL-X)
  161.  
  162.  
  163. The major differences between ELLE with the mined profile and mined are:
  164.  
  165. 1. The definition of a "word" is different for forward and backward word
  166. 2. The mark is set with CTRL-^ instead of CTRL-@
  167. 3. Use CTRL-G to abort a command instead of CTRL-\
  168. 4. Use CTRL-\ to literally insert the next character, instead of ALT
  169. 5. CTRL-E adjusts the window to put the cursor in the middle of it
  170. 6. To get and insert a file, use ESC G instead of CTRL-G
  171. 7. To go to line n, type ESC n CTRL-[ instead of CTRL-[ n
  172. 8. You exit with CTRL-X CTRL-X and then answer the question with "y".
  173. 9. There are many new commands, windows, larger files, etc.
  174.  
  175. 3. EMACS KEY BINDINGS
  176.  
  177. CURSOR MOVEMENT
  178.    CTRL-F         Forward one character.
  179.    CTRL-B         Backward one character.
  180.    CTRL-H         Same as CTRL-B: move backward one chara